home *** CD-ROM | disk | FTP | other *** search
/ Aminet 41 / Aminet 41 (2001)(Schatztruhe)[!][Feb 2001].iso / Aminet / comm / irc / UnrealIRCd-bin.lha / Unreal / ircd.conf < prev    next >
Text File  |  2000-11-24  |  22KB  |  523 lines
  1. #
  2. # IRC - Internet Relay Chat, doc/example.conf
  3. # Copyright (C) 1994, Helen Rose
  4. # $Id: example.conf,v 1.1.1.1.6.1.2.1 2000/11/24 18:07:30 codemastr Exp $
  5. #
  6. #   This program is free software; you can redistribute it and/or modify
  7. #   it under the terms of the GNU General Public License as published by
  8. #   the Free Software Foundation; either version 1, or (at your option)
  9. #   any later version.
  10. #
  11. #   This program is distributed in the hope that it will be useful,
  12. #   but WITHOUT ANY WARRANTY; without even the implied warranty of
  13. #   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14. #   GNU General Public License for more details.
  15. #
  16. #   You should have received a copy of the GNU General Public License
  17. #   along with this program; if not, write to the Free Software
  18. #   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  19. #
  20. # This is an example configuration file for the Unreal3.0-Morrican
  21. # and higher IRC servers.
  22. # 
  23. # You only need an ircd.conf (IRC server configuration file) if you are
  24. # running an IRC server. If you are running a standalone client this file
  25. # is not necessary.
  26. #
  27. # This file will explain the various lines in the IRC server
  28. # configuration file. Not all lines are mandatory. You can check to make
  29. # sure that your configuration file is correct by using the program
  30. # "chkconf", provided in the server distribution (and when you do "make
  31. # install" this program will be installed in the same directory as the irc
  32. # server). 
  33. #
  34. # This document modified for use by with the Unreal3.0 IRCD
  35. #
  36. #
  37. # The options for whether a line is needed or not are: 
  38. # MANDATORY: you absolutely MUST have this line
  39. # NETWORKED: you must have this line if you are connecting this irc
  40. #            server to any other server (servers can run standalone).
  41. # SUGGESTED: it is highly suggested that you use this line
  42. # OPTIONAL: it's completely up to you whether to define this or not
  43. # DISCOURAGED: you really really should not use this line if at all
  44. #              possible. 
  45. # OBSOLETE: an old or out of date line that isn't needed.
  46. #
  47. # MANDATORY lines are absolute *musts*, that is, if you do not have this
  48. # line then your server will not work properly. SUGGESTED lines are
  49. # close-to-mandatory (that is, the server will run without it, but you are
  50. # highly encouraged to use these lines).
  51. #
  52. # Note that "*" in a field indicates an "unused" field.
  53. #
  54. #
  55. # ========================================================================
  56. # NOTE! this entire configuration file is read UPSIDE-DOWN! So if you have
  57. # to put something in a specific order (for example, client-connection
  58. # lines), put them in reverse order!
  59. # ========================================================================
  60. #
  61. #
  62. # M: [MANDATORY]. This line sets your server's name, description, port
  63. # number, and IP address to bind to. Fields, in order, are: 
  64. #
  65. # If you leave IP address field blank or
  66. # *, it defaults to binding all local IP addresses on the machine.
  67. #
  68. # M:hostname:IP:Description Of Your Server:port:NS
  69. #
  70. # NS is a new feature in Unreal3.1. It is optional but it is recommended.
  71. # Every server on the network must have a completely unique NS. This number
  72. # will be used to identify the server.
  73. #
  74. M:server.my.net:*:My IRC Server:6667:34
  75. #
  76. # A: [MANDATORY]. This line lists your administrative information
  77. # (contact address, etc). To view this information, /admin (server) will
  78. # show it to you.
  79. #
  80. # The A: line has no set information, in fact, you can put arbitrary text
  81. # in there if you wish (it is encouraged that you put at *least* a contact
  82. # address for a person responsible for the irc server, however)
  83. #
  84. A:Generic Internet Access:Admin John Doe:jdoe@generic.com
  85. #
  86. # Y: [SUGGESTED]. These lines define connection classes. Connection
  87. # classes allow you to fine-tune your client and server connections. It is
  88. # suggested that clients and servers be placed in seperate classes, and if
  89. # you have lots of server connections (if you do have lots of servers you
  90. # shouldn't be reading this file :-) each set of servers (defined
  91. # arbitrarily by you) should have its own class. If you have clients
  92. # coming in from lots of different sites, you may want to seperate them
  93. # out into classes. For instance, you may want to put local users in one
  94. # class, with remote users in another class.
  95. #
  96. # The class numbers are not arbitrary. In auto-connecting servers -- that
  97. # is, servers that you have a port number (e.g. 6667) on the end of the C:
  98. # line (see below) the higher the number the higher the priority in
  99. # auto-connecting.
  100. #
  101. # The fields in order are: class number, ping frequency (in seconds),
  102. # connect frequency (in seconds), maximum number of links (used for
  103. # auto-connecting, and for limiting the number of clients in that class),
  104. # and sendq (this overrides any value set in include/config.h for #define
  105. # MAXSENDQLENGTH).
  106. #
  107. # Note that it is a good idea to have ping frequency the same at both ends
  108. # of the link.
  109. # 
  110. # in this case, connect-frequency is 0 indicating that this is a client
  111. # class (servers never connect to clients, it is the other way around).
  112. Y:1:90:0:20:100000
  113. #
  114. # These are the recommended server Y:lines for connecting to dalnet.
  115. # In addition to these you should have at *least* one client class, and one
  116. # oper class (see O:lines).  By convention on dalnet, these are usually
  117. # numbered from 5 to 10.
  118. #
  119. # Class 50 - Hub to hub, autoconnect
  120. Y:50:90:60:1:4000000
  121. #
  122. # Class 51 - Hub to hub, no autoconnect
  123. Y:51:90:60:0:4000000
  124. #
  125. # Class 30 - Hub to US leaf
  126. Y:30:90:0:0:3500000 
  127. #
  128. # Class 32 - Hub to EU leaf
  129. Y:32:180:0:0:3500000
  130. #
  131. # Class 34 - Hub to AU leaf
  132. Y:34:300:0:0:3500000
  133. #
  134. # Class 40 - US leaf to hub, autoconnect
  135. Y:40:90:90:1:3500000
  136. #
  137. # Class 41 - US leaf to hub, no autoconnect
  138. Y:41:90:90:0:3500000
  139. #
  140. # Class 42 - EU leaf hub
  141. Y:42:180:90:1:3500000
  142. #
  143. # Class 44 - AU leaf to hub
  144. Y:44:300:120:1:3500000
  145. #
  146. # I: [MANDATORY]. The I: lines are client-authorization lines. Without
  147. # these lines, no clients will be able to connect to your server.
  148. # Wildcards ("*") are permitted. Passwords are also permitted (clients can
  149. # be configured to send passwords).
  150. # 
  151. # Ident (for more information on this, see rfc1413) can also be used by
  152. # placing a @ in the appropriate fields.
  153. #
  154. # Fields are as follows:
  155. # I:IP-address-mask:optional password:domain-mask::connection class (opt)
  156. #
  157. # With a password..... This will allow anyone from anywhere to connect
  158. # as long as they know the password ("foobar"). Note listing this I: line
  159. # first, it will be read *last*, meaning it is the "fall-through". That
  160. # is, anyone who doesn't match the I: lines listed below must know the
  161. # password ("foobar") to connect.
  162. #
  163. I:*@*:foobar:*@*::1
  164. # This is a standard vanilla I: line which will permit anyone with an IP
  165. # address starting with 205.133 OR with a hostname ending in 
  166. # .toledolink.com to connect to the server. NOTE, the ircd matches on the 
  167. # *right-most* match, so if I connect as rmiller@glass.toledolink.com 
  168. # (which is rmiller@205.133.127.8) I will show up on irc as 
  169. # rmiller@glass.toledolink.com since that is the first match it found. 
  170. # (Even though the second match is valid). 
  171. I:205.133.*::*.toledolink.com::1
  172. # 
  173. # using ident
  174. I:*@205.133.*::*@*.toledolink.com::1
  175. # and you can even specify just certain usernames running ident (as long
  176. # as the client's site is running the ident daemon):
  177. I:NOMATCH::rmiller@glass.toledolink.com::1
  178. # putting NOMATCH in the first field will stop the ircd from matching
  179. # automatically against the IP address and it will force the server to
  180. # match against the hostname. (the "NOMATCH" string is not mandatory, you
  181. # can use any arbitrary text in the first field).
  182. I:*@*:ONE:*@*::1
  183. # putting the ONE in the password field makes it so that only 1 user matching
  184. # that host or IP can connect through that I:line.
  185. # 
  186. #
  187. # O: [OPTIONAL]. These lines define operator access. You do not need to
  188. # have an operator to run a server. A well configured leaf site should not
  189. # need an operator online, if it's connections are well defined, the irc
  190. # administrator can use kill -HUP on the ircd to reload the configuration
  191. # file. 
  192. # The fields are as follows:
  193. # O:hostname (ident "@" permitted):password:NickName:AccessFlags:class
  194. # if the person in "NickName" is not coming from the hostname defined in
  195. # the first field then the person will get the error message "No O: lines
  196. # for your host". 
  197. # NOTE that since Crypted Passwords are defined by default in
  198. # include/config.h this text probably will not be plaintext. See
  199. # ircd/crypt/README for more information.
  200. #
  201. # class is the Y:Line class you want this operator to end up in after they
  202. # have successfully /oper'd.
  203. #
  204. # Access flags may be left blank, or * to give full access rights. Flags
  205. # are in the form of single characters making a string.  Any combination
  206. # of the following can be used(these are cAsE sensitive characters):
  207. #
  208. # r = access to /rehash server
  209. # R = access to /restart server
  210. # D = access to /die server
  211. # h = oper can send /help ops
  212. # g = oper can send /globops
  213. # w = oper can send /wallops
  214. # l = oper can send /locops
  215. # c = access to do local /squits and /connects
  216. # L = access to do remote /squits and /connects
  217. # k = access to do local /kills
  218. # K = access to do global /kills
  219. # b = oper can /kline users from server
  220. # B = oper can /unkline users from server
  221. # n = oper can send local server notices(/notice $servername message)
  222. # G = oper can send global server notices(/notce $*.my.net message)
  223. # A = admin
  224. # u = oper can set /umode +c
  225. # f = oper can set /umode +f
  226. # ^ = oper can set /umode +I
  227. # e = oper can set /umode +e
  228. # W = oper can set /umode +W
  229. # H = oper gets auto +x on /oper
  230. # o = local oper, flags included: rhgwlckbBnuf
  231. # O = global oper, flags included: oRDCK
  232. # a = services admin, access to /samode
  233. # C = co admin
  234. # T = tech admin
  235. # A = admin
  236. # N = network admin access to remote /rehash and remote /restart and a bunch more
  237. # * = flags included: AaNCTzSHW^
  238.  
  239. #
  240. # This is a plain vanilla O:line:
  241. O:*.toledolink.com:nopassword:Russell:*:10
  242. #
  243. # and this line forces ident:
  244. O:rmiller@glass.toledolink.com:nopassword:Russell::10
  245. # 
  246. # This line is a generic "local operator", because of the flags, the only
  247. # thing that really makes them global operators, is if they have the flags
  248. # CKN set in their access flags.
  249. #
  250. # this line permits the nickname "jhs" with the password of "ITBites" to
  251. # be a local operator only (be able to issue commands locally -- can /kill
  252. # and /squit and /connect -- but *only* locally)
  253. #
  254. O:*.something.net:ITBites:jhs:o:10
  255. #
  256. # a crypted password line (NOTE that if you have crypted passwords, *all*
  257. # of you passwords must be crypted! In fact, if you are getting an error
  258. # "Incorrect Password" it may well be because crypted passwords are
  259. # defined and you have used plaintext.  So my example of plaintext and
  260. # crypted strings in the same IRC server configuration file is an
  261. # impossibility (but it is just theoretical, which is why I explained both).
  262. #
  263. O:rmiller@*.toledolink.com:T0eiVgHrqeKTQ:Russell::10
  264. #
  265. # U: [OPTIONAL]. This line defines the servers that IRC recognizes as being
  266. # allowed to make various changes to the IRC environment (mode changes, for
  267. # example), without complaining or otherwise obstructing them. For example,
  268. # DALnet requires the following line:
  269. U:services.my.net:*:*
  270. #
  271. # X: [ENCOURAGED]. This line defines the password that an operator must use
  272. # to restart or die the server. Note that they still myst have they R and D
  273. # flags. This is just a security precaution against  accidentaly typing
  274. # /die or /restart
  275. # X:<password for /DIE>:<password for /RESTART>
  276. X:diepass:restartpass
  277.  
  278. # C: [NETWORKED]. These lines define what servers your server tries to
  279. # connect to. 
  280. # N: [NETWORKED]. These lines define what servers your server permits
  281. # connections to be initiated from. 
  282. # C/N lines MUST be used in pairs. You cannot have one without the other. 
  283. #
  284. # C: lines contain the following fields:
  285. # C:remote server's hostname:passwd:remote server's name:port:conn class:options
  286. # N: lines contain the following fields:
  287. # N:remote server's hostname:passwd:remote server's name:host mask:conn class
  288. #
  289. # "host mask" is the number of parts in *your* hostname to mask to. For
  290. # instance, with my servername being "csa.bu.edu", if I wanted to present
  291. # my servername to be "*.bu.edu" I would have a host-mask portion of "1". 
  292. #
  293. # it is *strongly* advised that your C/N line passwords be different for
  294. # security's sake.
  295. #
  296. # ident is allowed in the server's hostname part of the field.
  297. # The options field in a C:line is only available as of Unreal3.1.1
  298. # Currently the only option is S which declares the link an SSL link.
  299. # If the other server is not compiled with SSL then the link will fail.
  300. #
  301. # these lines tell the server to automatically (note the port number, that
  302. # means automatic connection) connect to server2.my.net:
  303. C:foobar@server2.my.net:bigspark:server2.my.net:7000:32
  304. N:foobar@server2.my.net:bigalpha:server2.my.net::32
  305. #
  306. # This server's connection lines are more vanilla, masking the host to
  307. # *.toledolink.com (as described above):
  308. C:*.my.net:camelsrk00l:*.my.net::32
  309. N:*.my.net:andsoarellamas:*.my.net:1:32
  310. #
  311. # This this line makes use of the options field:
  312. # C:*.my.net:linkme:*.my.net:6667:32:S
  313. # N:*.my.net:linkme:*.my.net::32
  314. #
  315. # K: [OPTIONAL]. These lines define user@host patterns to be banned from
  316. # this particular server (with an optional time field). Note that K: lines
  317. # are *not* global, and if you ban a user they can still use any other IRC
  318. # server (unless they have specifically been banned there as well).
  319. #
  320. # The time field (same as reason) is only used if you #define
  321. # TIMED_KLINES in config.h, and even then they are discouraged.
  322. # 
  323. # the fields are defined as:
  324. # K:hostmask:reason:username
  325. # wildcards are permitted in any one of the fields, in other words, you can
  326. # K:*::* if you wanted (but your server wouldn't be used much ;-)
  327. #
  328. # Spaces are permitted in the reason field (you don't have to use _).
  329. # The /stats command has been modified to replace all spaces with _'s when
  330. # doing a /stats k. K:lines also allows you to specify a file to play to the
  331. # user when they are K:lined. To use this feature the reason must be in the
  332. # format of |filename. the filename must be kc.anythinghere, this is to prevent
  333. # the sending of text files such as your ircd.conf.
  334. #
  335. # This K: line bans the username "hrose" (the wildcards are used to make
  336. # sure that any ident-checking character will match) on any machine from
  337. # the University of Boston.
  338. K:*.bu.edu:Hacking #UnrealIRCD:*hrose*
  339. #
  340. # This K: line bans any users from acs*.bu.edu between the hours of 8am
  341. # and 12pm and 1pm and 5pm (the time is always the server's local time).
  342. # Time-based K-lines such as this require TIMED_KLINES in config.h to be
  343. # #defined.
  344. K:acs*.bu.edu:0800-1200,1300-1700:*
  345. # Note that 24 hour time is used (no "AM" or "PM").
  346. # This K: line bans all *.foobar.com users and will play the file |kc.flooding
  347. # to the user as the reason.
  348. K:*.foobar.com:|kc.flooding:*
  349. # 
  350. # E: [OPTIONAL]. This allows kline exceptions, even if a person matches
  351. # a K:line or /kline they are still allowed to connect.
  352. #
  353. # The fields are as follows
  354. # E:hostmask:reason:usermask
  355. # 
  356. E:foo.bar.com:Oper on this server:*john21*
  357. #
  358. #
  359. # q: [DISCOURAGED]. These lines "quarantine" specified servers.  Because
  360. # of the way they operates, the same q: lines MUST be installed by
  361. # everyone or the net will keep breaking. I CANNOT EMPHASIZE THIS ENOUGH.
  362. # Do NOT use q: lines lightly!
  363. #
  364. # This is NOT a nick q-line, if you wish to quarantine a NICK, see below.
  365. #
  366. # The fields are as follows:
  367. # q:*:reason why quarantine is in place:servername
  368. #
  369. q::this server is too slow and lags the net:cm5.eng.umd.edu
  370. #
  371. # Q: [OPTIONAL]. Different from the above type of q: line, these lines
  372. # prevent users on your server from picking certain nicks. This is useful
  373. # if your network has 'reserved' nicknames that should not be taken by
  374. # normal users.  Note the difference in capitalization and BE CAREFUL!
  375. #
  376. # The fields are as follows:
  377. # Q:*:reason why quarantine is in place:nickname
  378. #
  379. # For example, You might want to use the following lines:
  380. Q::Reserved for services:ChanServ
  381. Q::Reserved for services:NickServ
  382. Q::Reserved for services:MemoServ
  383. Q::Reserved for services:OperServ
  384. Q::Reserved for services:HelpServ
  385. Q::Reserved for services:StatServ
  386. Q::Reserved for operators:IRCop
  387. Q::Reserved for operators:*Oper*
  388. Q::Reserved for administrators:Admin*
  389. #
  390. # 
  391. # T: [OPTIONAL]. These allow you to specify different MOTD and RULES files
  392. # based on a users host.  This is made so you can have MOTDs in different
  393. # languages so all users can see the MOTD and understand it.
  394. #
  395. # The fields are as follows:
  396. # T:host:motdfile:rulesfile
  397. #
  398. # T:*.fr:french.motd:french.rules
  399. #
  400. #
  401. # e: [OPTIONAL]. These lines allow you to specify a host which will not 
  402. # be scanned by the proxy scanner when they connect. This is made so you
  403. # can allow some open proxys to connect while still killing others. Make
  404. # sure you use an IP and not a host for this line or it will not work.
  405. # NOTE: These are not the same as E:lines.
  406. #
  407. # The fields are as follows:
  408. # e:IP:*:*
  409. #
  410. # e:123.123.123:*:*
  411. #
  412. #
  413. # Z: [DISCOURAGED]. These block ALL incoming connections from a certain
  414. # IP address mask.  They can stop users who log on and issue the SERVER
  415. # command a couple of times just to annoy irc ops.  They are more
  416. # powerful that K-lines because they can stop users before they've had a
  417. # chance to register.  This works on servers, SO BE VERY CAREFUL WITH
  418. # YOUR Z-LINE MASKS.  Z-lines are a LAST RESORT.  They are much too
  419. # dangerous and powerful to be using them instead of K-lines and akills.
  420. #
  421. # NOTE 1: Z-lines do NOT work on host names!  Only IP addresses.
  422. # NOTE 2: Z-lines are part of /stats k.  
  423. # NOTE 3: The :* at the end is REQUIRED.  Not using it will cause both
  424. # ircd and chkconf to segfault without saying why.
  425. #
  426. # Syntax:
  427. # Z:IP mask:reason for zapping:*
  428. Z:127.0.0.1:Please don't log on from the local machine:*
  429. #
  430. # L: [OPTIONAL]. These lines "Leaf" specified servers. They are only
  431. # useful if you are a non-leaf site yourself. There are two ways you can
  432. # use L: lines. The first will limit one particular site to a particular
  433. # tree depth (including 0, which would mean the server has to connect with
  434. # no servers linked behind it otherwise the connection will fail). The
  435. # second will allow you to be selective about which other servers you wish
  436. # the connecting server to behave as a leaf towards.
  437. #
  438. # The fields are as follows:
  439. # L:disallow connections to this hostmask::server name:depth
  440. # For example, this will force kaja.gi.alaska.edu to connect only as a
  441. # leaf (if it is not a leaf, the link will be dropped):
  442. L:::kaja.gi.alaska.edu
  443. # This line will force cm5.eng.umd.edu to have a depth of only 1 below it
  444. # (that is, it is allowed to have only leaves connected to it):
  445. L:::cm5.eng.umd.edu:1
  446. #
  447. # This line will prohibit anything matching *.edu to be connected behind
  448. # any server matching *.au:
  449. L:*.edu::*.au
  450. #
  451. # H: [OPTIONAL]. These lines define who you permit to act as a "hub" to
  452. # you (that is, who you permit to connect non-leafed servers to you).
  453. #
  454. # the first field may use wildcards, the third field *must* be an exact
  455. # match for a server's name (NOT a server's hostname, if they differ, the
  456. # server's name must be used). If the servername is a wildcard (e.g. *.au)
  457. # that is an acceptable name for the third field. 
  458. #
  459. # The fields are as follows:
  460. # H:servers which are permitted entry::hub server
  461. #
  462. # Example, permit server.my.net to allow any servers behind it to 
  463. # connect: 
  464. H:*::server2.my.net
  465. #
  466. # Example, permit irc-2.mit.edu to allow any MIT servers behind it to
  467. # connect: 
  468. H:*.mit.edu::irc-2.mit.edu
  469. #
  470. # P: [OPTIONAL]. This field allows the server to listen on various ports
  471. # (other than 7000) for connections.
  472. #
  473. # You can now bind internet ports to specific IP interface devices.  To do
  474. # this put the IP address of the interface in the host field.  To bind to
  475. # all interfaces, leave empty or put * in.
  476. #
  477. # P:lines can be limited to specific connections. For example you can make
  478. # a port listen for only server connections. The currently available flags
  479. # are:
  480. #
  481. # S - Server Only
  482. # C - Client(User) Only
  483. # J - JavaChat (for CR Java Client)
  484. # s - Secure SSL
  485. # * - CS flags
  486. #
  487. # The fields are as follows::
  488. # P:IP# or UNIX socket file:*:*:port number
  489. # for example, an internet domain socket on port 6665 for the local
  490. # computer
  491. P:127.0.0.1:*:*:6665
  492. #
  493. # Examples using flags
  494. P:127.0.0.1:S:*:6666
  495. P:127.0.0.1:C:*:7000
  496. #
  497. # V: [OPTIONAL]. These lines are very complex and allow you to deny a 
  498. # server from linking based on what version of Unreal they are running,
  499. # as well as what flags the IRCd was compiled with.
  500. #
  501. # The fields are as follows:
  502. # V:protocol:flags:servermask
  503. # 
  504. # The format for the protocol field is as follows:
  505. # >protocol - denys any protocols higher than that specified
  506. # <protocol - denys any protocols lower than that specified
  507. # =protocol - denys the specified protocol
  508. # !protocol - denys all but the specified protocol
  509. #
  510. # The format for the flags field is as follows:
  511. # flag - server must have the specifed flag
  512. # !flag - server may not have the specified flag
  513. #
  514. # Examples:
  515. # V:<2302:*:*
  516. # V:*:S:hub.*
  517. # V:=2301:!S:*
  518.  
  519.  
  520.  
  521.  
  522.  
  523.